fiffJ* ft- 



7. OM Implementation Details 

7.1. OMCD 



7.1.1. Data Structures 

typedef 

struct vpn_descr\iptor__s 
{ 



TAG_DECL; 

dlcl_list_t 

dlcl_list_t 

lck_mutex_t 

uint32_t 

int 

char 



list; 
vr_list ; 
vr_lock; 

r 

numb_of _vrs ; 
narte [NAMELEN+1] ; 



int 






kdmin_ 


status ; 


VPN */ 










#def ine 


VPN_ 


_ADM_ 


_create\ 


0x0001 


#def ine 


VPN_ 


_ADM_ 


GO \ 


0x0002 


#def ine 


VPN_ 


_ADM_ 


_suspend\ 


0x0004 


#def ine 


VPN_ 


_ADM_ 


_DESTROY \ 


0x0008 


#def ine 


VPN_ 


_ADM_ 


_NOT_EXIS'Tl 


0x0100 


#def ine 


VPN_ 


_ADM_ 


_INACTIVE_\ 


0x0200 


#def ine 


VPN_ 


_ADM_ 


ACTIVEf" > 


"0x0400 


int 






/ oper_? 


status ; 



#define VPN_OPER_DO 
#define VPN_OPER_INfET 
ttdefine VPN_OPER_UP 
#define VPN_OPER_FA JLT_RECO> 

int \ mark^ 

long tin 
base */ 

} vpn_descriptor_t ; 
typedef 

struct vr_descriptor_s 

{ 



run time type identification */ 

List of all VPNs */ 

list of all VR for this VPN */ 

Globally unique VPN id */ 

/* Number of VR's in this VPN */ 

VPN name */ 

/* Administrative status of the 



event 
event 
event 
event 
state 
state */ 
state */ 



*/ 
*/ 
*/ 
*/ 
*/ 



/* Operational status of the VPN */ 



to delete vpn in CBR data base */ 
when data was send to CBR data 



/* run time type identification */ 

/* List of all VRs in a VPN */ 

/* Identifies VR */ 

/* Identifies VPN to which VR 



TAG_DECL; 

dlcl_list_t list; 
ipaddr_t id; 
vpn_descriptor_t *vpn; 
belongs */ 

object_group_id_t group; /* Identifies group to which VR mapped */ 
int admin_status; /A Administrative status of the VR */ 

#define VR_ADM_CREATE 0x0001 \ /* event */ 

#define VR_ADMJ30 0x0002 \ /* event */ 

#define VR ADM SUSPEND 0x0004 \ /* event */ 
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#define VR_ADM_D E S TROY 0x0008 

#define VR_ADM_NOT_EXIST 0x0100 

#define VR_ADM_INACTIVE 0x02 00 

#define VR ADM ACTIVE 0x0400 



■ /* event */j 
/* state 
/* state // 
/* stats' */ 
Operational frtatus of the VR */ 



int oper_status; 

#define VR_OPER_DOWN 0x01 

#define VR_OPER_INIT 0x02 

#define VR_OPER_UP 0x04 

#define VR_OPER_FAULT_RE COVER Y 0x08 

int marked; /* Used to delete 7 vpn in CBR data base */ 

long timestamp; /* Time when data was send to 

data base */ 

} - vr_descriptor_t ; 



CBR 



7.1.2. API 



7.1.2.1. Create /Destroy API 



FUNCTION 


EFFECT 


ARGUMENTS 


om_c r e a t e_vpn 


Create VPN wtfh specified VPN 
ID. Returns/ SUCCESS or 
FAILURE. / 


VPN ID 


om_create_vr 


Create VR/for existing VPN with 
specified / VR ID. Returns 
SUCCESS or FAILURE. 


VPN ID, VRID 


om_de s t roy_vpn 


Destroys VPN and all VRs 
configured in the VPN. Returns 
SUCCESS or FAILURE. 


VPN ID 


om_destroy_vr / ft 


Destroys VR. Returns SUCCESS or 
' FAILURE. 

/ ^ 


VPN ID, VRID 


7.1.2.. 


\ IOCTL^I 


FUNCTION 




^ " EFFECT 


ARGUMENTS 


om_ioctl \ y 


Sends IOCTL with data to object of 
the specified class, which belongs 
to the VR, identified by < VPN ID, 
VR ID>. Returns SUCCESS or 
FAILURE in case of system failure 
or any other status supplied by the 
object-specific IOCTL handler. 


VPN ID, VR ID, class id, IOCTL 
code, data pointer, length 


om_i o c t l_by_olD j _i d 


Sends IOCTL with data to object 
identified by supplied object id. 
Returns SUCCESS or FAILURE in 
case of system failure or any other 
status supplied by the object- 
specific IOCTL handler. 


Object ID IOCTL code, data 
pointer, length 



yi 
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# # 



7.1.2.3. Check existence 



FUNCTION 


EFFECT / 


ARGUMENTS 


om_i s_vpn_ex i s t 


Checks the existence of the VR, 
which is specified by the <VPly ID, 
VR ID>. Return TRUE if sv(ch a 
VPN exist and FALSE otherwise 


VPN ID 


om_i s_vr_exi s t 


Checks the existence of ttfe VPN, 
which is specified by the/VPN ED. 
Return TRUE if such a/VPN exist 
and FALSE otherwise / 


VPN ID, VR ID 


7. L 2. 4. Attribute A ccess / 


FUNCTION 


EFFfeCT 


ARGUMENTS 


om__get_f irst_vpn 


Looks up first/ VPN ih the global 
list of VPNs/ in the single IPSX 
system. Retyfns ID of the first VPN 

11 at ICaoL AJ11C V-TI^ CAl&Lo, allU \J 

otherwise/ 




om_get_next_vpn 


Searched the global list of the VPNs 
on the/ single Orion for the next 
VPN /after the one, specified by 
VPiy ID. If VPN ID is 0, then it 
Vetytns VPN ID of the first VPN. If 
tW VPN specified by VPN ID does 
fjpt exist, then function returns next 
Uarger VPN ID than specified one. 
/(Returns 0 if no VPNj^as created, or 
Ahere is no VPN^ith VPN ID and 
' there is noi^fVPN. 


VPN ID 


om_get_f irst_vr // 


Looks up first VR in the list of the 
VRs, which belong to the VPN with 
VPN ID in the single Orion. 
Returns pointer to the VR ID at 
least one VR exists, and NULL 
otherwise. Returns NULL if there is 
no VPN with supplied VPN ID. 


VPN ID 


om_get_next_vr / 


Looks up the next VR after one, 
specified by the VR ID in the list of 
the VRs, which belong to the VPN 
with VPN ID in the single Orion. If 
VPN ID is not valid, then function 
returns NULL. If VR with specified 
VR ID does not exist, then function 
returns a pointer to the VR with 
next valid VR ID. Returns NULL if 
no VR was created in VPN with 


VPN ID, VRID 
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VPN ID, or there is ruf next VR 
after VR with specified/VR ID. 




om_ge t_vpn_name 


Gets a name of a VPttf, specified by 
the VPN ID. SUCCESS is returned 
if the VPN with WN ID was found 
and FAILURBr is returned 
otherwise. / 


VPN ID, name pointer, name size 


om_s e t_ypn_name 


Sets a name 0/ a VPN, specified by 
the VPN ID7SUCCESS is returned 
if the VPN Adth VPN ID was found 
and FAILURE is returned 
otherwise*; 


VPN ID, name pointer, name size 


om_get_vr_name 


Gets a liame of a VR, specified by 
the VBN ID and VR ID. SUCCESS 
is returned if the VR was found and 
FAILURE is returned otherwise. 


VPN ID, VR ID, name pointer, 
name size 


om_s e t_vr_name 


Set& a name of a VR, specified by 
thfe <VPN ID, VR ID> SUCCESS 
is returned if the VR was found and 
/FAILURE is returned otherwise. 


VPN ID, VR ID, name pointer, 
name size 


om_get_vr_type / 


Gets a type of a VR, specified by 
the VPN ID and VR ID. SUCCESS 
is returned if the VR was found and 
FAILURE is returned otherwise. 


VPN ID, VR ID, VR type 


om_set_vr /£ype / A 
[ l\l \ 


Sets a type of a VR, specified by 
the <VPN ID, VR ID>. SUCCESS 
is returned if the VR^as found and 
FAILURE is^petimied otherwise. 


VPN ID, VR ID, VR type 



7.2. OMORIG 



/* List of all object IDs in the 

/* List of all object IDs in the 

/* Sorted Global List of all object 

/* Global List of all object IDs in 



7.2.1. Data Structures 

typedef 

struct oid /link s 
{ 

TAG_DE 

dlcl_l/.st_t grp_lst ; 

group */ 

die 11 i s t_t omor i_l s t ; 

group 

die 1/1 i s t_t global_JL s t ; 

IDs in Ehe system */ 

dlcl__list_t list; 
the system */ 

objtect_id_t id; 
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int 
base */ 

long 
data base */ 
} oid_link_t; 



marked; 
time stamp; 



/* Used to delete oid in CBR data 
/* Time when/ data was send to CBR 



7.2.2. Message Tags 

/* OMORI and OMORIG reply tag */ 
#de f ine OM_RE PL Y_TAG 0x4 0 0 C 

The following tags are sent by OMORIG to/OMORI 



#def ine 


OMORI 


_DESTROY_GRP_OBJS_TAG 


0X4/S03 


#def ine 


OMORI 


_MV_0 B J_TO_GR P_T AG 


0x4 005 


#def ine 


OMORI 


_CREATE_OBJ_TAG 


0x4009 


#def ine 


OMORI 


_DE S TRO Y_OB J_TAG 


/0x4011 


#def ine 


OMORI 


_ACT I VATE_OB J_TAG / 


0X4013 


#def ine 


OMORI 


_STOP_OBJ_TAG / 


0x4 015 


#def ine 


OMORI 


_FORWARD_OB J_I D_TAG/ 


0x4019 


#def ine 


OMORI 


_IOCTL_TAG / 


0x4021 


#def ine 


OMORI 


_UPDATE_VR_ATTR_TAG 


0x4023 


#def ine 


OMORI_ 


_UPDATE_GRP_TAG / 


0x4025 


#def ine 


OMORI 


UPDATE OBJ TAG/ 


0x4 02 7 



7.2.3. API 



7.2.3.1. Group Membership Change 



FUNCTION 


1 EFFECT 


ARGUMENTS 


omorig add obj id 

/ 


( ' 


l Adfls object ID to the OM Global 
Wtabase. Returns SUCCESS or 
^VILURE 


Object ID 




f 




Removes object lb from the OM 
Global database. Returns 


Object ID 


7.23.2 




FUNCTION // 


EFFECT 


ARGUMENTS 


omorig_get_f irst_groufc 


Returns pointer to the first group in 
the DB 


Pointer to the group hash table 


omorig_get_next_groufc> 


Returns pointer to the next after the 
specified group in the DB 


Pointer to the group hash table and 
the pointer to the group 


omorig_lookup_group A>y_id 


Looks up group by the specified 
group ID. Returns pointer to the 
group descriptor if found and 


GROUP ID 
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NULL otherwise. 



omo r i g_ 1 o okup_o i d 



Looks up OID link in the DB fey 
specified ID. Returns pointer to /{he 
OID link if found and N]OLL 
otherwise. 



Object ID 




7.3. OMORI 



m 



7.3.1. Data Structures 

typedef 

struct obj_descriptor_s 
{ 

TAG_DECL ; 
dlcl_list_t 
dlcl_list_t 
object_id_t 
int 

uint32_t 
ipaddr_t 

global_address_t obj_i 
different address space */ 

uint32_t timesta 
} obj__descriptor t;. 



global_list ; 
list; /* 
id; /* Uni 
class id; 



/* run time type identification */ 
/* Global list of all objects */ 
List of all objects in the group */ 
e object id in the group context */ 
/* Identifies class of the object */ 



vpn__id; 
vr id; 



Identifies VPN to which object belongs */ 
/* Identifies VR */ 
tance; /* Identifies the object in 

/* Time when object was registered */ 



7.3.2. Message Tags) 

The following? tags 

#define OMORIG_ADD 

OMORIG RM ,raa^IDJEfiG 
OMORIG_MV^pBJ_ID_TAG 
OMORIG FORWARD OBJ ID TAG 



#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 



OMORIG REGISTER FUNS TAG 



OMORIG J&PDATEJDBJ_ID_TAG 
0MORIG^UPDATE_GRP_TAG 
OMORI j/FRWD_IOCTL_TAG 
OMOR M_ 1 D_REQ_T AG 
OMOR£_CLAS S_0 1 D_REQ_TAG 
OMORI G_UPDATE_GRP_DONE_TAG 0x502 6 
OMORIG UPDATE OBJ DONE TAG 0x502 8 



MORI to OMORIG 

0x5005 
0x5006 
0x5007 
0x5009 
0x5011 
0x5013 
0x5014 
0x5015 
0x5017 
0x5019 



7.3.3. APL 



7.3\3.LCreate /Destroy API 



FUNCTION 



EFFECT 



ARGUMENTS 
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# 



omori_obj_register 


Registers object to th£ OM 
Database. Returns SUCCESS or 
FAILURE / 


CLASS ID, Object ID, 
pointer to object 


omo r i_ob j _de r eg i s t e r 


Deregisters object fr^rn the OM 
Database. Returns SUCCESS or 
FAILURE / 


Object ID 


omor i__a s s i gn_and_r eg i s t e r_ob j _i d 


Registers object/ to the OM 
database, but requests OM to 
assign object IE) to the registered 
object. Returns SUCCESS or 
FAILURE / 


CLASS ID, Object ID, 
pointer to object 


omo r i_c r e a t e_ob j 


Creates ob/ect of specified class 
in the specified group. If object of 
this class in the group already 
exists and unique flag is TRUE, 
then existing object ID will be 
returned, otherwise new object 

will /hp rrpatpd 


VPN ID, VR ID, GROUP 
ID, CLASS ID, address 
space id, unique flag. 

Returns object id. 


omori_create_active_obj 

/ 


Sapie as omori_create_obj but 
a^ter successful creation sends 
ACTIVATE_OBJECT IOCTL to 
/the object 


VPN ID, VR ID, GROUP 
ID, CLASS ID, address 
space id, unique flag. 

Returns object id. 


omori_destroy_obj / 

M/ 


Sends STOP_OBJECT IOCTL to 
the object if it was in ACTIVE 
jstate and after this destroys object 
Joy sending DESTROY OBJECT 
IOCTL to the object and then 
destroying all management 
information regarding this object. 


Object ID 



733.2.Group Membership Change 



FUNCTION /I 


EFFECT 


ARGUMENTS 


omori_add_obj_to group // 


Adds object to the specified group. 
If object reviously belong to 
another group it removes from the 
first group and add to the new. 
Returns SUCCESS or FAILURE 


Object ID, GROUP ID 


omorig_remove_obj_id / 


Removes object from the group 
where it belongs and moves it to the 
group 0 (OM_BASE_GROUP). 
Returns SUCCESS or FAILURE 


Object ID 



7. 3. 3.3. Attribute Access 



FUNCTION 



EFFECT 



ARGUMENTS 
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omor i_ge t_ob j _group 


Returns Group ID of the group xd 
which object belongs, if object k% 
not local then information / is 
retrieved from the OMORIG / 


Object ID 


omori_get_address_space 


Returns address space ID of the 
group to which object belongs, if 
object is not local then information 
is retrieved from the OMOKIG 


Object ID 


omori_get_local_obj_ref erence 


Returns pointer to the local object 
and NULL if object is not local 


Object ID 



7.4. Transaction layer 



7.4.1. Data Structures 

typedef 

struct om_request_s 
{ 

TAG_DECL; 
dlcl_list_t 
int 

om_c a 1 1 b a c k_f 
void 
int 

addre s s_spac e_t 
} om_r e que s t _ t ; 
typedef 

struct om_req__cooki^ 
{ 

TAGJDECL; 
int 

address_space_t 
int 

} om_req_cookie_t ; 



7.4.2. API 




list; 
index; 
*func; 
. *cookie; 
tag; 
dest ; 



/* run time type identification */ 

/* List of requests */ 

/* matching index */ 

/* callback function */ 



/* Destination address */ 



n time type identification */ 
* Request ID */ 
/* Address of the request originator */ 
/* message tag */ 



FUNCTION / 


EFFECT 


ARGUMENTS 


om_send_request / 


Sends data to the destination, adds 
transaction control header in front 
of the packet, allocates a request, 
adds it to the request list. If 
callback function is NULL then 
free request. 


Data packet, destination address, 
tag, callback function, request 
cookie. 


om_recv__requestf 


Receive request, allocate request 
cookie, save request id and source 


Data packet 
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address in it. / 




om_send_reply 


Sets message/fag, depending on the 
channel, which data sent on. Sends 
data to /the destination, adds 
transaction control header in front 
of the racket, free request cookie 


Data packet, request cookie, tag, 
channels to send reply on. 


om_recv_reply 


Recede reply, calls callback 
/ fun<aipn from the transaction 
con toI block (om_request_t). After 

pn/ninlptinn "Itpp thp rpnnp^t 

l/VJll llJllvLlUll 11 Lilt i&UUtOli 


Data packet 


om_get_request_tag / 


Retrieves message"" tag of the 
Aecruestr* — 


Request cookie 


om_get_request_src \J 


-Retrieves address of the originator 
of the request. 


Request cookie 


om_abort_requests_by_addr / 


Abort all the transactions associated 
with the address. 


Address of the peer 
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